Skip to content

docs: establish Codex alignment roadmap - #180

Merged
oratis merged 2 commits into
mainfrom
codex/codex-alignment-plan
Aug 2, 2026
Merged

docs: establish Codex alignment roadmap#180
oratis merged 2 commits into
mainfrom
codex/codex-alignment-plan

Conversation

@oratis

@oratis oratis commented Aug 1, 2026

Copy link
Copy Markdown
Owner

Summary

  • records the full DeepCode audit against current Codex design, including the pro/con review and arbitration
  • establishes a safety-first, staged modernization roadmap instead of continuing unverified parity claims
  • adds repository guidance and documentation consistency checks
  • expands the TypeScript root build to LSP/VS Code and adds Tauri Rust checks/tests to CI
  • retires stale Electron shipping instructions and marks legacy status documents as historical snapshots

Why

DeepCode's clients share runAgent but assemble sessions, permissions, hooks, sandboxing, cancellation, and credentials differently. The review also found that VS Code/LSP can omit the central permission gate, LSP abort does not cancel work, the desktop renderer holds provider credentials, and a TypeScript server cannot simply be moved into the current Tauri bundle without a packaging decision.

This PR makes those facts explicit, defines the decision order, and creates a trustworthy baseline before runtime changes begin.

Impact

No runtime behavior changes. Contributors get one current plan, a root AGENTS.md, accurate setup/test commands, and CI coverage for previously omitted TypeScript projects and the Rust backend.

Validation

  • pnpm docs:check
  • pnpm typecheck
  • pnpm lint (3 pre-existing warnings, no errors)
  • pnpm format:check
  • pnpm test (910 passed, 12 conditional skips)
  • pnpm build
  • cargo check --manifest-path apps/desktop/src-tauri/Cargo.toml --locked
  • cargo test --manifest-path apps/desktop/src-tauri/Cargo.toml --locked (28 passed)

@oratis

oratis commented Aug 2, 2026

Copy link
Copy Markdown
Owner Author

Review: approved ✅

Scope: docs + CI only — no runtime behavior change, which matches the stated intent.

What I verified

  • docs/CODEX_ALIGNMENT_PLAN.md (+408) reads as an honest audit rather than a parity claim. The four findings it calls out (VS Code/LSP omitting the permission gate, LSP abort not cancelling, renderer holding provider credentials, TS server not droppable into the current Tauri bundle) are each real and each gets a dedicated follow-up PR later in this stack — I checked that Runtime safety: mandatory policy and real cancellation #181/Runtime: bind host safety services behind RuntimeHost #184/feat: move desktop runtime behind app server #192/docs: decide desktop runtime packaging #187 actually close them, so this is a roadmap with delivery behind it, not aspiration.
  • scripts/check-docs.mjs (+77) is a genuine consistency gate, not a no-op; pnpm docs:check passes.
  • tsconfig.json/ci.yml: root build now covers LSP + VS Code, and Tauri cargo check/cargo test join CI. Those two projects were previously outside the typecheck graph — worth having.
  • Retiring the Electron instructions in SHIPPING_MAC.md (-160 net) is correct; that path has not been real since the Tauri move.

Note (not blocking): marking MORNING_REPORT.md, DEVELOPMENT_PLAN.md, HANDOFF.md, BEHAVIOR_PARITY.md as historical snapshots is the right call — those had drifted from code repeatedly. The new plan doc becomes the SSOT; keeping it that way is the maintenance cost being accepted here.

Validation: CI green on both runners. Locally at the stack tip (#210): typecheck, lint (--max-warnings=0), format, docs-check, and 1033 tests across 8 packages all pass.

Merging as the base of the #180#210 stack.

@oratis
oratis merged commit 024550e into main Aug 2, 2026
4 checks passed
@oratis
oratis deleted the codex/codex-alignment-plan branch August 2, 2026 06:34
@oratis
oratis restored the codex/codex-alignment-plan branch August 2, 2026 06:35
oratis added a commit that referenced this pull request Aug 2, 2026
…ajors (#215)

Covers the 31-PR Codex alignment stack (#180-#210) plus the dependency
work (#211-#214, #155, #177-#179).

Leads with the security section because that is what this release is:
the central tool gate could be skipped entirely when `mode` was omitted
(#181), and the desktop renderer held provider credentials (#192).

Upgrade notes call out the two things a user could otherwise be
surprised by — the ~6.7 MB → ~115 MB desktop size increase from the Node
sidecar, and that the plugin capability RPC is not an OS boundary.

Co-authored-by: t <t@t>
Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant